Get User Followers

GET /:username/followers

Description

Returns a paginated list of followers for a user.

Request Parameters

Requires Authentication: true

PATH PARAMS

Name	Type	Required	Description
username	string	Yes	Username of the target account.

QUERY PARAMS

Name	Type	Required	Description
page	number	No	Page number. Default is 1.
maxPageSize	number	No	Page size. Maximum is 20.

Usage Example

await axios.get("https://api.daykeeper.app/johndoe/followers?page=1", {
  headers: {
    Authorization: `Bearer ${accessToken}`,
  },
})

Success Response

{
  "message": "followers fetched successfully",
  "data": [],
  "page": 1,
  "pageSize": 0,
  "maxPageSize": 20,
  "totalPages": 0,
  "totalCount": 0,
  "user": [
    {
      "_id": "65cbaab84b9d1cce41e98b60",
      "username": "johndoe"
    }
  ]
}

Error Response

Code	Description
401	Missing or invalid access token
402	One of the users is blocked
404	User not found
409	Private account route not accessible to the viewer
500	Server error